Mã lỗi của luồng eKYC
Các mã lỗi được trả về từ hệ thống eKYC của FPT AI có thể được chia thành 3 loại chính gồm các mã lỗi chung, mã lỗi OCR/NFC và mã lỗi kiểm tra khuôn mặt.:
- Các mã lỗi chung: Đây là các mã lỗi sinh ra do việc sử dụng không đúng hướng dẫn các API trong luồng eKYC (gửi thiếu/sai thông tin, hết quota, ...) hoặc các mã lỗi không xác định khác dẫn tới việc request không tới được engine xử lý của hệ thống eKYC
Đối với các trường hợp request thành công tới được engine xử lý của hệ thống, lỗi trả về gồm có lỗi liên quan đến OCR/NFC và lỗi liên quan đến kiểm tra khuôn mặt:
-
Các mã lỗi OCR/NFC: các lỗi được phát hiện khi hệ thống kiểm tra ảnh giấy tờ hoặc dữ liệu trong chip NFC của giấy tờ. Các lỗi này được chia thành các nhóm sau:
-
Các mã lỗi kiểm tra khuôn mặt: các lỗi được phát hiện khi hệ thống kiểm tra Liveness và so khớp khuôn mặt.
1. Các mã lỗi chung
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 500 | -1 | There is something wrong. Please try again. | Có lỗi xảy ra. Vui lòng thử lại. | Có lỗi không xác định xảy ra trong quá trình xử lý request |
| 200 | 400 | api-key must be provided | Thiếu hoặc sai API key | |
| 200 | 400 | document-type header must be provided | Thiếu thông tin về loại giấy tờ. Các giá trị cho phép bao gồm "idr" / "dlr" / "passport" | |
| 200 | 400 | document-type value is invalid | Thông tin về loại giấy tờ đã được cung cấp nhưng không nằm trong các giá trị cho phép. Các giá trị cho phép bao gồm "idr" / "dlr" / "passport" | |
| 401 | Invalid token | Token không hợp lệ | ||
| 403 | 403 | Session expired | Phiên thực hiện eKYC hết hạn | |
| 200 | 400 | uuid must be provided | Thiếu thông tin về session id | |
| 200 | 400 | country code value is invalid | Thông tin về mã quốc gia không hợp lệ. Giá trị cho phép là "vi" | |
| 200 | E101 | Front picture must be taken first | Sai thứ tự chụp ảnh. Vui lòng chụp mặt trước rồi đến mặt sau | Mặt trước giấy tờ phải được gửi đi trước |
| 200 | E102 | Document type is not supported | Loại giấy tờ không được hỗ trợ | Loại giấy tờ không hợp lệ. Các giá trị cho phép bao gồm "idr" / "dlr" / "passport" |
| 200 | E103 | Please capture your rear document | Vui lòng chụp mặt sau giấy tờ | Khi đã gửi mặt trước trong phiên rồi thì không thể gửi tiếp mặt trước |
| 200 | E104 | Please ensure that you request the correct number of files | Vui lòng upload số lượng file đúng yêu cầu | Chỉ được upload đúng số lượng file được yêu cầu (1 hoặc 2 files trong 1 request) |
| 200 | E105 | Your age is not within the permitted range | Tuổi của bạn không nằm trong phạm vi cho phép | Chỉ có thể thực hiện eKYC nếu người dùng trong độ tuổi hợp lệ |
| 403 | -1 | Session expired | Phiên làm việc đã hết hạn | (Lỗi phiên làm việc) Phiên làm việc đã hết hạn |
| 403 | 0 | Invalid hash | Mã băm không hợp lệ | (Lỗi phiên làm việc) Mã băm gửi lên không hợp lệ |
| 403 | 1 | Please capure your document first | Hãy thực hiện bước chụp ảnh giấy tờ trước | (Lỗi phiên làm việc) Bước chụp ảnh giấy tờ trước chưa được thực hiện |
| 403 | 2 | Retry limit exceeded | Quá số lần thử cho phép | (Lỗi phiên làm việc) Hết số lần thử cho phép trong phiên làm việc |
| 403 | 3 | Session is not complete | Phiên làm việc chưa hoàn thành | (Lỗi phiên làm việc) Phiên làm việc chưa hoàn thành |
2. Các mã lỗi OCR/NFC
2.1. Lỗi file đầu vào OCR
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | 1 | Invalid Parameters or Values! | Giá trị tham số không hợp lệ | Sai thông tin khi gửi request |
| 200 | 3 | Unable to find the selected document in the image | Không tìm thấy tài liệu đã chọn trong ảnh | Không tìm thấy giấy tờ hợp lệ trong ảnh (không có giấy tờ đúng loại hoặc chất lượng giấy tờ quá kém) |
| 200 | 7 | Invalid image file | File ảnh không đúng định dạng | File ảnh gửi lên bị hỏng |
2.2. Lỗi liên quan tới chất lượng ảnh OCR
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | QC00 | Unable to find the selected document in the image | Không tìm thấy tài liệu đã chọn trong ảnh | Không tìm thấy giấy tờ hợp lệ trong ảnh (không có giấy tờ đúng loại hoặc chất lượng giấy tờ quá kém) |
| 200 | QC01 | Image resolution is too low | Ảnh có độ phân giải quá thấp | Độ phân giải của ảnh quá thấp Tối thiểu là 640x480. |
| 200 | QC02 | Image has bright spot(s) | Ảnh bị bóng sáng | Giấy tờ trong ảnh bị bóng |
| 200 | QC03 | Image is blurry | Ảnh bị mờ | Ảnh bị mờ |
| 200 | QC04 | Image has bad luminance | Ảnh bị quá sáng hoặc quá tối | Giấy tờ trong ảnh bị bóng |
| 200 | QC05 | The image's document size is too small compared to the image | Ảnh bị kích thước tài liệu quá nhỏ so với ảnh | Diện tích giấy tờ trong ảnh quá nhỏ so với tổng diện tích ảnh |
2.3. Lỗi liên quan tới giả mạo OCR
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | FC01 | Document is black-and-white photocopy | Giấy tờ là bản photocopy đen trắng | Giấy tờ là bản photocopy đen trắng |
| 200 | FC02 | Document has been re-captured from LCD screen | Giấy tờ là bản chụp lại từ màn hình LCD | Giấy tờ là bản chụp lại từ màn hình LCD |
| 200 | FC03 | Document has been edited or is colored photocopy | Giấy tờ đã bị chỉnh sửa hoặc bản photocopy màu | Giấy tờ là bản photocopy màu hoặc đã bị chỉnh sửa |
| 200 | FC04 | Document has been cornered | Giấy tờ bị cắt góc | Giấy tờ bị cắt góc |
| 200 | FC05 | Missing face on front side of document | Thiếu khuôn mặt trên mặt trước của giấy tờ | Không tìm thấy khuôn mặt ở mặt trước của giấy tờ |
| 200 | FC06 | Missing QRcode on front side of document | Thiếu QRcode trên mặt trước của giấy tờ | Không tìm thấy QRcode ở mặt trước của căn cước công dân gắn chip |
| 200 | FC07 | Missing MRZ on back side of document | Thiếu MRZ trên mặt sau của giấy tờ | Không tìm thấy vùng MRZ ở mặt sau của căn cước công dân gắn chip |
| 200 | FC08 | Missing emblem on front side of document | Thiếu quốc huy trên mặt trước của giấy tờ | Không tìm thấy quốc huy ở mặt trước của CMND/CCCD |
| 200 | FC09 | Missing headline on front side of document | Thiếu tiêu ngữ trên mặt trước của giấy tờ | Không tìm thấy tiêu ngữ ở mặt trước của CMND/CCCD |
| 200 | FC10 | Missing title on front side of document | Thiếu tiêu đề trên mặt trước của giấy tờ | Không tìm thấy tiêu đề ở mặt trước của CMND/CCCD |
| 200 | FC11 | Missing fingerprint on back side of document | Thiếu vân tay trên mặt sau của giấy tờ | Thiếu dấu vân tay ở mặt sau của CMND/CCCD |
| 200 | FC12 | Missing stamp on back side of document | Thiếu con dấu trên mặt sau của giấy tờ | Không tìm thấy con dấu ở mặt sau của CMND/CCCD |
| 200 | FC13 | Missing chip on back side of document | Thiếu chip trên mặt sau của giấy tờ | Không tìm thấy chip ở mặt sau của căn cước công dân gắn chip |
| 200 | FC14 | OCR result is uncertain | Kết quả OCR không chắc chắn | |
| 200 | FC15 | ID is uncertain | Kết quả OCR của trường ID không chắc chắn | |
| 200 | FC16 | Front side and back side are not from the same background | Mặt trước và mặt sau có nền không giống nhau | Nền ảnh của ảnh mặt trước và mặt sau giấy tờ khác nhau một cách bất thường |
| 200 | FC17 | Missing barcode on back side of document | Thiếu mã vạch trên mặt sau của giấy tờ | Không tìm thấy vùng mã vạch ở mặt sau của căn cước công dân không chip |
| 200 | FC18 | Missing Anti-counterfeiting stamps on back side of document | Thiếu tem chống hàng giả trên mặt sau của giấy tờ | Không tìm thấy tem chống giả ở mặt sau của căn cước công dân không chip |
| 200 | FC19 | Document has been watermark | Giấy tờ bị đóng dấu mờ | Giấy tờ bị đóng watermark |
| 200 | FC20 | Document has been perforated | Giấy tờ bị đục lỗ | Hộ chiếu có dấu hiệu bị đục lỗ vùng MRZ |
2.4. Lỗi hậu kiểm OCR
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | E-1 | Cannot do postcheck | Không thể thực hiện postcheck | Có lỗi xảy ra trong quá trình thực hiện hậu kiểm |
| 200 | E01 | There is a blank field | Có một hoặc nhiều trường bị trống | Có trường trống trong kết quả OCR |
| 200 | E02 | ID format is not correct | Cấu trúc ID sai | Format của số ID không đúng |
| 200 | E03 | DoB format is not correct | Cấu trúc ngày sinh sai | Format của ngày sinh không đúng |
| 200 | E04 | DoB is later than today | Ngày sinh không thể sau ngày hôm nay | Ngày sinh trong kết quả OCR không thể sau ngày hôm nay |
| 200 | E05 | Current age cannot be smaller than 14 | Tuổi hiện tại không thể dưới 14 | Tuổi hiện tại dưới 14 tuổi không hợp lệ |
| 200 | E06 | Nationality is not correct | Quốc tịch không đúng | Quốc tịch phải là Việt Nam |
| 200 | E07 | Year in DoB does not match with ID number | Năm sinh không khớp với số ID | Năm sinh không khớp với số ID |
| 200 | E08 | Gender code does not match | Mã giới tính không khớp với số ID | Mã giới tính trong số ID không khớp |
| 200 | E09 | DoE format is not correct | Cấu trúc ngày hết hạn không đúng | Format của ngày hết hạn không đúng |
| 200 | E10 | ID card has been expired | Giấy tờ hết hạn | Giấy tờ hết hạn |
| 200 | E11 | DoE cannot be KHÔNG THỜI HẠN | Ngày hết hạn không thể là không thời hạn | Ngày hết hạn không thể là KHÔNG THỜI HẠN đối với giấy tờ gửi lên |
| 200 | E12 | DoI format is not correct | Cấu trúc ngày cấp không đúng | Format của ngày cấp không đúng |
| 200 | E13 | DoI is later than today | Ngày cấp không thể sau ngày hôm nay | Ngày cấp trong kết quả OCR không thể sau ngày hôm nay |
| 200 | E15 | Please send images of the front and the back side of same type ID (old or new ID) | Hai mặt của giấy tờ không khớp | Hai mặt của giấy tờ không cùng loại (áp dụng cho các loại giấy tờ không phải CCCD gắn chip) |
| 200 | E16 | There is a blank field in the front side | Có một hoặc nhiều trường bị trống ở mặt trước | Có trường trống trong kết quả OCR của mặt trước |
| 200 | E17 | Age at issue date cannot be smaller than 14 | Tuổi trên giấy tờ dưới 14 ở thời điểm cấp | Tuổi ở năm cấp giấy tờ CMND/CCCD không thể dưới 14 |
| 200 | E18 | DoE should be DoI + 15 years | Ngày hết hạn phải là ngày cấp cộng thêm 15 năm | Ngày hết hạn của giấy tờ gửi lên phải là 15 năm kể từ ngày cấp |
| 200 | E19 | DoE should be birthday at 25 years old | Ngày hết hạn phải là ngày sinh nhật 25 tuổi | Ngày hết hạn của giấy tờ gửi lên phải là sinh nhật 25 tuổi |
| 200 | E20 | DoE should be birthday at 40 years old | Ngày hết hạn phải là ngày sinh nhật 40 tuổi | Ngày hết hạn của giấy tờ gửi lên phải là sinh nhật 40 tuổi |
| 200 | E21 | DoE should be birthday at 60 years old | Ngày hết hạn phải là ngày sinh nhật 60 tuổi | Ngày hết hạn của giấy tờ gửi lên phải là sinh nhật 60 tuổi |
| 200 | E22 | DoE should be KHÔNG THỜI HẠN | Ngày hết hạn phải là không thời hạn | Ngày hết hạn của giấy tờ gửi lên phải là KHÔNG THỜI HẠN |
| 200 | E30 | Front side and back side are not from the same card | Mặt trước và mặt sau giấy tờ không khớp | Hai mặt không phải của cùng một giấy tờ (áp dụng cho CCCD gắn chip) |
| 200 | E31 | Issue location does not match issue date | Nơi cấp không khớp với ngày cấp | Tùy khoảng thời gian mà giấy tờ được cấp, nơi cấp sẽ có thay đổi tương ứng (áp dụng cho CCCD không chip và CCCD gắn chip) |
| 200 | E32 | Type of document does not match issue date | Loại giấy tờ không khớp với ngày cấp | Áp dụng cho trường hợp Căn cước công dân có chip: CCCD có chip bắt đầu được phát hành từ ngày 23/01/2021. Với trường hợp Căn cước 2024: CC bắt đầu được phát hành từ ngày 01/07/2024. |
| 200 | E33 | DoE should be birthday at 14 years old | Áp dụng cho trường hợp Căn cước mới 2024 có chip: Ngày hết hạn phải là ngày sinh nhật 14 tuổi. | |
| 200 | E36 | Current age cannot smaller than 6 | Tuổi hiện tại không thể dưới 6 | |
| 200 | E37 | Age at issue date cannot smaller than 6 | Tuổi trên giấy tờ dưới 6 ở thời điểm cấp đối với Căn cước 2024 | |
| 200 | E110 | Wrong side-type of document | Sai mặt giấy tờ | Gửi sai mặt giấy tờ. Ví dụ: thông tin side-type là "front" nhưng lại gửi ảnh mặt sau |
| 200 | QR01 | QR code does not match OCR result | QR code không khớp với kết quả OCR | Có ít nhất một trường thông tin trong kết quả QRcode không khớp với kết quả OCR |
| 200 | QR02 | QR code format is not correct | QR code không đúng định dạng | Mã QR không hợp lệ với loại giấy tờ hoặc có lỗi xảy ra trong quá trình xử lý mã QR |
| 200 | MRZ01 | MRZ format error | Lỗi định dạng MRZ | MRZ không đủ 3 dòng hoặc độ dài dòng không đúng |
| 200 | MRZ02 | MRZ contains invalid characters | MRZ chứa ký tự không hợp lệ | Có ký tự không thuộc tập cho phép A-Z, 0-9 và < |
| 200 | MRZ03 | Info fields in MRZ mismatch with OCR | Trường thông tin trong MRZ không khớp với dữ liệu OCR | Trường thông tin trong MRZ không khớp với dữ liệu OCR (id_number, dob, doe, gender, nationality, name) |
| 200 | MRZ04 | Info fields in MRZ have invalid formats | Định dạng trường thông tin trong MRZ không hợp lệ | Định dạng các trường trong MRZ không hợp lệ (dob, doe, name) |
| 200 | MRZ05 | Info fields in MRZ have invalid check digits | Mã kiểm tra của các trường thông tin trong MRZ không đúng | Các mã kiểm tra không đúng (check digit) |
2.5. Mã lỗi check chip
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | 0 | Check chip thành công | Check chip successfully | Request check chip thành công |
| 200 | CC01 | Data is not integrity | Dữ liệu trong chip không toàn vẹn | Dữ liệu trong chip không toàn vẹn |
| 200 | CC02 | Data is clone | Dữ liệu bị sao chép | Dữ liệu bị sao chép |
| 200 | CC03 | C06 authentication failed | Xác thực BCA thất bại | Xác thực BCA thất bại |
3. Các mã lỗi kiểm tra khuôn mặt
| HTTP Code | Error Code | English Error Message | Vietnamese Error Message | Meaning |
|---|---|---|---|---|
| 200 | 200 | Không có lỗi | ||
| 200 | 301 | Face in video is spoof | Kiểm tra thực thể sống không thành công | Kiểm tra thực thể sống thất bại |
| 200 | 302 | Video seems like deepfake | Video có dấu hiệu chỉnh sửa | Video có dấu hiệu chỉnh sửa |
| 200 | 303 | Face is not matching with document | Khuôn mặt không khớp với giấy tờ | Khuôn mặt trong video/ảnh selfie không khớp với khuôn mặt trên giấy tờ |
| 200 | 406 | Face quality is not good enough (covered, too dark/bright..) | Chất lượng video không đạt (khuôn mặt bị che, ngược sáng,..) | Chất lượng ảnh khuôn mặt không tốt (bị che, quá tối hoặc quá sáng, ...) |
| 200 | 407 | No face/More than 1 face in document | Không tìm thấy hoặc có nhiều hơn 1 khuôn mặt trong giấy tờ | Không tìm thấy hoặc có nhiều hơn 1 khuôn mặt trong giấy tờ |
| 200 | 408 | More than 1 face in the video | Xuất hiện nhiều hơn 1 khuôn mặt trong khung hình | Có nhiều hơn 1 khuôn mặt trong video/ảnh selfie |
| 200 | 409 | No video uploaded/Wrong extension/Video is too short/Invalid input | Video quá ngắn | Không có video được tải lên / Video tải lên sai định dạng / Video tải lên quá ngắn /Video tải lên không hợp lệ |
| 200 | 410 | No face/Lost face in the video | Mất dấu khuôn mặt trong quá trình quay video | Không tìm thấy khuôn mặt hoặc khuôn mặt bị mất trong video |
| 200 | 411 | The face is too small | Khuôn mặt quá nhỏ, vui lòng đưa lại gần màn hình hơn | Khuôn mặt trong video quá nhỏ |
| 200 | 412 | The face is too blurry | Video quá mờ | Khuôn mặt trong video bị mờ |
| 200 | 413 | Video is still image | Video trông giống ảnh | Video quay lại ảnh tĩnh |
| 200 | 422 | No frontal face in video | Không xuất hiện khuôn mặt thẳng trong khung hình | Không tìm thấy khung hình có khuôn mặt trực diện trong video |
| 200 | 423 | Face is out of frame during video | Khuôn mặt bị ra khỏi khung hình | Khuôn mặt bị ra khỏi khung hình |
| 200 | 424 | The requested face pose is not valid | Quay trái phải không hợp lệ | Quá trình quay trái phải không hợp lệ |
| 200 | W100 | Please do not close your eyes | Vui lòng không nhắm mắt | Phát hiện nhắm cả 2 mắt |
| 200 | W103 | Please do not close your eyes | Vui lòng không nhắm mắt | Phát hiện nhắm mắt trái |
| 200 | W104 | Please do not close your eyes | Vui lòng không nhắm mắt | Phát hiện nhắm mắt phải |
| 200 | W105 | Please do not close your eyes | Vui lòng không nhắm mắt | Phát hiện nhắm mắt phải |